home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / linux / howto.news < prev    next >
Encoding:
Text File  |  1995-07-25  |  30.9 KB  |  838 lines

  1. Subject: Linux News HOWTO
  2. Newsgroups: comp.os.linux.announce,comp.os.linux.admin,comp.answers,news.answers
  3. From: vince@victrola.wa.com (Vince Skahan)
  4. Date: Fri, 18 Nov 1994 17:25:36 GMT
  5.  
  6. Archive-name: linux/howto/news
  7. Last-modified: 26 Oct 94
  8.  
  9.   The Linux News HOWTO
  10.   Vince Skahan, <vince@halcyon.com>
  11.   v1.14, 22 Oct 1994
  12.  
  13.   This document describes the setup and care+feeding of USENET News
  14.   under Linux.  You need to read this if you plan to post or read USENET
  15.   news either locally on your site or between your site and other sites.
  16.   You probably do *not* need to read this document if don't plan to pro-
  17.   vide USENET news as a feature of your system.
  18.  
  19.   1.  Introduction
  20.  
  21.   The intent of this document is to answer some of the questions and
  22.   comments that appear to meet the definition of "frequently asked
  23.   questions" about USENET News software under Linux in general, and the
  24.   version in the Linux SLS distribution in particular.
  25.  
  26.   This document and the corresponding Mail and UUCP "HOWTO" documents
  27.   collectively supersede the UUCP-NEWS-MAIL-FAQ that has previously been
  28.   posted to comp.os.linux.announce.
  29.  
  30.  
  31.   1.1.  New versions of this document
  32.  
  33.   New versions of this document will be periodically posted to
  34.   comp.os.linux.announce, comp.answers, and news.answers.  They will
  35.   also be added to the various anonymous ftp sites who archive such
  36.   information including sunsite.unc.edu:/pub/Linux/docs/HOWTO.
  37.  
  38.  
  39.   In addition, you should be generally able to find this document on the
  40.   Linux WorldWideWeb home page at http://sunsite.unc.edu/mdw/linux.html
  41.   and on my home page at http://www.halcyon.com/vince/welcome.html.
  42.  
  43.  
  44.   1.2.  Feedback
  45.  
  46.   I am interested in any feedback, positive or negative, regarding the
  47.   content of this document via e-mail.  Definitely contact me if you
  48.   find errors or obvious omissions.
  49.  
  50.   I read, but do not necessarily respond to, all e-mail I receive.
  51.   Requests for enhancements will be considered and acted upon based on
  52.   that day's combination of available time, merit of the request, and
  53.   daily blood pressure :-)
  54.  
  55.   Flames will quietly go to /dev/null so don't bother.
  56.  
  57.   Feedback concerning the actual format of the document should go to the
  58.   HOWTO coordinator - Matt Welsh (mdw@sunsite.unc.edu).
  59.  
  60.  
  61.   1.3.  Copyright Information
  62.  
  63.   The News-HOWTO is copyrighted (c)1994 Vince Skahan.
  64.  
  65.   A verbatim copy may be reproduced or distributed in any medium
  66.   physical or electronic without permission of the author.  Translations
  67.   are similarly permitted without express permission if it includes a
  68.   notice on who translated it.
  69.  
  70.   Short quotes may be used without prior consent by the author.
  71.   Derivative work and partial distributions of the News-HOWTO must be
  72.   accompanied with either a verbatim copy of this file or a pointer to
  73.   the verbatim copy.
  74.  
  75.   Commercial redistribution is allowed and encouraged; however, the
  76.   author would like to be notified of any such distributions.
  77.  
  78.   In short, we wish to promote dissemination of this information through
  79.   as many channels as possible. However, we do wish to retain copyright
  80.   on the HOWTO documents, and would like to be notified of any plans to
  81.   redistribute the HOWTOs.
  82.  
  83.   We further want that ALL information provided in the HOWTOS is
  84.   disseminated.  If you have questions, please contact Matt Welsh, the
  85.   Linux HOWTO coordinator, at mdw@sunsite.unc.edu.
  86.  
  87.  
  88.   1.4.  Standard Disclaimer
  89.  
  90.   Of course, I disavow any potential liability for the contents of this
  91.   document.  Use of the concepts, examples, and/or other content of this
  92.   document is entirely at your own risk.
  93.  
  94.  
  95.   1.5.  Other sources of information
  96.  
  97.  
  98.   1.5.1.  USENET
  99.  
  100.  
  101.      news.admin.misc         General topics of network news administration.
  102.      news.admin.policy       Policy issues of USENET.
  103.      news.admin.technical    Maintaining network news. (Moderated)
  104.      news.software.b         Discussion about B-news-compatible software.
  105.      news.software.nn        Discussion about the "nn" news reader package.
  106.      news.software.nntp      The Network News Transfer Protocol.
  107.      news.software.readers   Software used to read network news.
  108.      news.sysadmin           Comments directed to system administrators.
  109.      news.announce.newusers  Explanatory postings for new users. (Moderated)
  110.      news.newusers.questions Q & A for users new to the Usenet.
  111.  
  112.  
  113.  
  114.  
  115.   1.5.2.  Books
  116.  
  117.   The following is a non-inclusive set of books that will help
  118.  
  119.  
  120.   o  "Managing UUCP and USENET" published by O'Reilly+Associates is in
  121.      my opinion the best book out there for figuring out the programs
  122.      and protocols involved in being a USENET site.
  123.  
  124.   o  "Unix Communications" published by The Waite Group contains a nice
  125.      description of all the pieces (and more) and how they fit together.
  126.  
  127.   o  "Practical Unix Security" published by O'Reilly+Associates has a
  128.      nice discussion of how to secure UUCP in general.
  129.  
  130.   o  "The Internet Complete Reference" from Osborne is a fine reference
  131.      book that explains the various services available on Internet and
  132.      is a great source for information on news, mail, and various other
  133.      Internet resources.
  134.  
  135.  
  136.   o  "The Linux Networking Administrators' Guide" from Olaf Kirch of the
  137.      Linux DOC Project is available on the net and is also published by
  138.      (at least) O'Reilly and SSC.  It makes a fine one-stop shopping to
  139.      learn about everything you ever imagined you'd need to know about
  140.      Unix networking.
  141.   1.6.  Where NOT to look for help
  142.  
  143.   There is nothing "special" about configuring and running USENET news
  144.   under Linux (any more).  Accordingly, you almost certainly do *NOT*
  145.   want to be posting generic news-related questions to the
  146.   comp.os.linux.* newsgroups.
  147.  
  148.   Unless your posting is truly Linux-specific (ie, "please tell me what
  149.   patches are needed to run INN with the bash1.12 in SLS v1.03") you
  150.   should be asking your questions in the newsgroups mentioned above.
  151.  
  152.   Let me repeat that.
  153.  
  154.   There is virtually no reason to post anything news-related in the
  155.   comp.os.linux hierarchy any more.  There are existing newsgroups in
  156.   the news.*  hierarchy to handle *ALL* your questions.
  157.  
  158.   IF YOU POST TO COMP.OS.LINUX.* FOR NON-LINUX-SPECIFIC QUESTIONS, YOU
  159.   ARE LOOKING IN THE WRONG PLACE FOR HELP.  THE USENET NEWS EXPERTS HANG
  160.   OUT IN THE PLACES INDICATED ABOVE AND GENERALLY DO NOT RUN LINUX.
  161.  
  162.   POSTING TO THE LINUX HIERARCHY FOR NON-LINUX-SPECIFIC QUESTIONS WASTES
  163.   YOUR TIME AND EVERYONE ELSE'S AND IT FREQUENTLY DELAYS YOU FROM
  164.   GETTING THE ANSWER TO YOUR QUESTION.
  165.  
  166.   2.  Hardware Requirements
  167.  
  168.   There are no specific hardware requirements for USENET News under
  169.   Linux.  The only requirement of any type is sufficient disk space to
  170.   hold the software itself, the threads database(s), and the amount of
  171.   news you wish to keep on the system.  Figure on a minimum of 10 MB of
  172.   disk space for starters.
  173.  
  174.  
  175.   3.  Getting USENET News software
  176.  
  177.   All the software referenced in this "HOWTO" is available on the usual
  178.   Internet anonymous ftp sites.
  179.  
  180.   Looking in /networking/news on ftp.uu.net is usually a good way to
  181.   start.
  182.  
  183.   The newspak-2.4.tar.z distribution contains config files and readme
  184.   files related to building uucp, news, and mail software under Linux
  185.   from the various freely-available sources.  It can usually be found in
  186.   sunsite.unc.edu:/pub/Linux/system/Mail/news.  If you can't find it on
  187.   sunsite, please send me mail and I'll make sure you get a copy of it.
  188.  
  189.  
  190.   4.  News Transport Software
  191.  
  192.   There are two main sets of news "transport" software for *nix these
  193.   days, Cnews and INN.  The old "Bnews" has been declared officially
  194.   dead and unsupported by its authors.
  195.  
  196.   News "transport" is defined here to be the software that works behind
  197.   the scenes to post and propagate the news articles as well as making
  198.   the articles available for the newsreaders to access.
  199.  
  200.   You can set your paths to anything you like, as long as UUCP has the
  201.   absolute path to rnews in the Permissions file and as long as you have
  202.   your newsreaders configured so that they can find "inews" and "mail".
  203.  
  204.   Important - you're asking for trouble if you try to intermix Cnews and
  205.   INN.  Pick one or the other.  It's ok to add the NNTP "Reference
  206.   Release" into Cnews since they're intended to play well together.
  207.   4.1.  Cnews Performance Release
  208.  
  209.   The current de-facto standard news software is Cnews.  It has been
  210.   around for a number of years, I first saw it sometime around 1988.
  211.  
  212.   Cnews's main benefit is its maturity.  It runs on about every *nix you
  213.   can find and there are literally thousands of systems running it
  214.   worldwide.
  215.  
  216.   Its main disadvantage is that it seems to have been intended for uucp-
  217.   over-modem connections between sites and as such requires the addition
  218.   of NNTP software to handle realtime Internet feeds and reading.
  219.  
  220.   In addition, it requires external threading packages for the various
  221.   newsreaders, although the NOV package can now be hooked in to help
  222.   somewhat and it's rumored to have native NOV support in the upcoming
  223.   "cleanup" release.
  224.  
  225.   Regardless, the beginning USENET admin should probably run Cnews first
  226.   since it's so stable, well documented, and has many thousands of
  227.   experienced administrators who can answer questions.
  228.  
  229.   The newspak distribution on sunsite contains working config files for
  230.   Cnews under Linux as well as a couple line patch you'll need to make
  231.   to "doexplode" to get around some problems with bash1.12.
  232.  
  233.  
  234.   4.1.1.  Installing Cnews
  235.  
  236.   Installing the Performance Release of Cnews is absolutely a "rtfm"
  237.   project.  Just grab the sources, extract them, and follow the
  238.   instructions.
  239.  
  240.   The build.def in newspak was generated by running "build" the first
  241.   time and simply looking up the answers by checking out the
  242.   /usr/include files to get the right answers.
  243.  
  244.   When you start the actual compilation, it'll blow up a couple of
  245.   times.  In all cases, you'll need to simply comment out a couple of
  246.   atoi() and atol() macros that gcc doesn't like when your doit.bin
  247.   compilation blows up.
  248.  
  249.   Also, you need the following tiny change to doexplode to get around
  250.   some bash1.12 bugs or else you won't feed anything downstream.i
  251.  
  252.  
  253.           (from Steve Robbins -  steve@nyongwa.cam.org )
  254.  
  255.           if [ ! -f $f ] ; then continue; fi              # add this line
  256.           #       case "$f" in                            # comment me out
  257.           #       "out.master/[0-9]*")    break ;;        # comment me out
  258.           #       esac                                    # comment me out
  259.  
  260.  
  261.   Henry Spencer of Cnews fame says that the code in doexplode that is
  262.   currently causing problems with bash is on the list to be revised in a
  263.   future release.
  264.  
  265.   It is uncertain at this time if the need for this patch goes away if
  266.   you switch to the bash1.13 now available for Linux.  I switched to the
  267.   new bash and libs and left the patch in place and nothing broke (for
  268.   what that's worth :-)
  269.  
  270.   Steve Robbins also has determined that the recent 'cleanup release' of
  271.   Cnews has found a bug in GNU 'join' from shellutils-1.9.  There are a
  272.   few patches needed to the sources for join to deal with the problem.
  273.   4.1.2.  Configuring Cnews
  274.  
  275.   At the very least, you need to edit the following files that all
  276.   should be in /usr/local/lib/news:
  277.  
  278.  
  279.   active             - the active file
  280.   batchparms         - batch parameters
  281.   explist            - article expiration setup
  282.   mailname           - name in headers for mailed replies
  283.   mailpaths          - path to mail moderated postings to
  284.   organization       - your "org"
  285.   sys                - control what you take and feed
  286.   whoami             - your hostname for the Path: line
  287.  
  288.  
  289.  
  290.  
  291.   4.1.3.  Maintaining a Cnews Site
  292.  
  293.   First, a significant rule of thumb is to not mess with files by hand
  294.   that have utilities that configure them. In particular don't set up
  295.   newsfeeds (run "addfeed" instead) and don't mess with your active file
  296.   (run "addgroup").  When in doubt, read and re-read the docs in the
  297.   source distribution.
  298.  
  299.   Everything else can be done via cron.  My crontab for "news" looks
  300.   like the following:
  301.  
  302.  
  303.           # take the compressed batches that came in from other systems
  304.           20 *       * * * /usenet/sw/news/bin/input/newsrun
  305.  
  306.           # batch 'em up to go out
  307.           0 *        * * * /usenet/sw/news/bin/batch/sendbatches myfeedsite
  308.  
  309.           # expire C-news
  310.           59 0       * * * /usenet/sw/news/bin/expire/doexpire
  311.  
  312.           # monitor stuff and report if needed
  313.           10 5       * * * /usenet/sw/news/bin/newsdaily
  314.           00 5       * * * /usenet/sw/new/bin/newswatch
  315.  
  316.           # turn processing of incoming news batches off 6:30AM - 4:00 PM
  317.           30 6       * * * /usenet/sw/news/bin/input/newsrunning off
  318.           00 16      * * * /usenet/sw/news/bin/input/newsrunning on
  319.  
  320.  
  321.  
  322.  
  323.   4.2.  InterNetNews (INN)
  324.  
  325.   INN is the newcomer on the scene, but it's gaining popularity as it
  326.   matures.  Its main benefit is speed and the fact that it contains an
  327.   integrated nntp package.  Its main drawback is that it's new and that
  328.   it doesn't necessarily install and run flawlessly on the many
  329.   "standard *nixes" yet.  In addition, it operates by having a daemon
  330.   (the innd) always running plus potentially a overchan daemon to do
  331.   threading.  The tradeoff seems to be memory vs. speed.
  332.  
  333.   New USENET admins should probably not try INN until they have
  334.   experience with either B-news or Cnews.  While it's fast and reliable
  335.   under Linux, it's virtually undocumented for the beginning news
  336.   administrator (though in practice it's rather simple to run once you
  337.   figure it out).
  338.  
  339.   INN is very particular about its permissions.  Don't mess with them.
  340.  
  341.   INN is also very particular about having a "quality" TCP/IP to work
  342.   with.  Linux is not necessarily all the way there at this time, so it
  343.   is recommended that you grab a Linux-specific INN distribution from
  344.   one of the usual Linux archive sites.
  345.  
  346.  
  347.   4.2.1.  Installing INN
  348.  
  349.   ( from Arjan de Vet - devet@info.win.tue.nl )
  350.  
  351.   I've made a patch + config kit for INN 1.4 to get it to run on Linux.
  352.   It can be found at:
  353.  
  354.   ftp.win.tue.nl:/pub/linux/ports/inn-1.4-linux.tar.gz
  355.  
  356.   INN depends heavily on a good /bin/sh substitute. I use a beta version
  357.   of bash 1.13 that is now available for Linux on the normal archive
  358.   sites.  bash 1.12 gives some small problems with newgroups not being
  359.   handled correctly (maybe some other problems too, I don't remember).
  360.  
  361.  
  362.   4.2.2.  Configuring INN
  363.  
  364.   Basically follow Arjan's instructions and you'll be all set.  Here's
  365.   the summary of what to do:
  366.  
  367.  
  368.   o  In config.data, make sure you have "HAVE_UNIX_DOMAIN DONT"
  369.  
  370.   o  Add the hostname of the system running innd to hosts.nntp For a
  371.      uucp-only site, that's your sitename.
  372.  
  373.   o  Make sure you do not have a line for nntp in /etc/inetd.conf
  374.  
  375.   o  Make sure that you have innshellvars say "HAVE_UUSTAT DO" rather
  376.      than the "DONT" in his example config.data if you have uustat from
  377.      the Taylor UUCP package installed.  If you have this defined wrong,
  378.      it'll result in no outgoing news getting batched.
  379.  
  380.   o  If you run INN, definitely define the recommended syslogd stuff
  381.      because it is very, very helpful.
  382.  
  383.      There is a spectacular (!!!!) FAQ for INN that comes out monthly.
  384.      Look on rtfm.mit.edu for it.  You'll be glad you did.
  385.  
  386.  
  387.   4.2.3.  Maintaining a INN Site
  388.  
  389.   I've found that there's essentially zero care-and-feeding of a Linux
  390.   INN site other than having a working cron.  Basically you want a
  391.   crontab that looks something like the following:
  392.  
  393.  
  394.           # daily maint, also expire the .overview database and articles
  395.           1 0 * * * /usenet/sw/inn/bin/news.daily expireover delayrm < /dev/null
  396.  
  397.           # send 'em out
  398.           5 * * * * /usenet/sw/inn/lib/send-uucp
  399.  
  400.  
  401.  
  402.   ( if you switch to bash1.13, the "< /dev/null" above is not needed )
  403.  
  404.  
  405.   4.3.  Other News Transport Agents
  406.  
  407.   The following is a non-inclusive list of other news transport software
  408.   known to work under Linux:
  409.  
  410.   o  dynafeed
  411.  
  412.   o  nntp1.5.11
  413.  
  414.   o  slurp1.05
  415.  
  416.  
  417.   5.  News Readers
  418.  
  419.   There is no "one true newsreader".  As a result, there are many well-
  420.   known newsreaders that port easily to Linux in particular.  At this
  421.   writing, "tin", "trn", and "nn" are in most of the commonly available
  422.   distributions of Linux and in.
  423.  
  424.   When picking a newsreader, you basically want to find something that
  425.   is easy to use, very configurable by the user, with threading and kill
  426.   files (to select interesting articles or make the non-interesting ones
  427.   not appear at all).
  428.  
  429.   You can set your paths to anything you like as long as all the
  430.   newsreaders can find "inews" from your Cnews or INN installation and a
  431.   "mail" program to send mail replies to posts.
  432.  
  433.   This section will talk briefly about several of the most popular ones.
  434.   Before you ask, I use "nn" for lots of reasons :-)
  435.  
  436.  
  437.   5.1.  Tin
  438.  
  439.   Tin is a threaded newsreader generally intended to be easy for new
  440.   users.  It supports kill files and NOV threading.  If you're running
  441.   INN, it will read NOV .overview files by default and not write index
  442.   files.
  443.  
  444.   To compile Tin under linux, basically just edit the makefile to set
  445.   the locations of the software (especially the location of inews) and
  446.   type "make linux".  There are no patches required for tin under Linux.
  447.  
  448.   For threading, you can basically just say "tin -u" to update the index
  449.   files.
  450.  
  451.   To enable the ability to read via NNTP, compile with "NNTP_ABLE"
  452.   defined.  This will result in a file called "tin" for local and one
  453.   called "rtin" for NNTP reading.  "tin -r" will also get the same
  454.   behavior as "rtin".
  455.  
  456.   Iain Lea recommends the following crontab entry and says that you need
  457.   to do a "make daemon" to make tind.
  458.  
  459.  
  460.           # thread the database
  461.           35 * * * * /usenet/bin/tind -u
  462.  
  463.  
  464.  
  465.   I've run tin over a SLIP link as a NNTP-based newsreader.  If you're
  466.   connecting to a system that has a full newsfeed, you will grow
  467.   extremely old waiting for it to load up the "active" file.
  468.  
  469.  
  470.  
  471.   5.2.  Trn/Mthreads
  472.  
  473.   trn is a threaded derivative of the "rn" newsreader.  trn3.2 and newer
  474.   has the nice ability to select either the "mthreads" (trn's threading
  475.   package) or NOV (threader from INN) threading.
  476.  
  477.   To compile it, just run Configure and take the calculated defaults.
  478.   You might need to have lib4.4.1 and bash-1.13 (there is a beta now
  479.   available on the various Linux archive sites) to successfully run
  480.   Configure.  You'll probably need both bash1.13 and libs4.4.1 to get
  481.   the new Configure to run properly.
  482.  
  483.   The newspak distribution on sunsite contains working config files for
  484.   trn under Linux.
  485.  
  486.   It's probably unwise to try to edit a trn config.sh by hand unless
  487.   you're doing something *VERY* simple like changing the paths to fit
  488.   your tastes.  If you do so, you'll need to run "Configure -S" before
  489.   you "make depend", "make", and "make install".
  490.  
  491.   Although "Configure" fails generally under Linux with bash1.12,
  492.   "Configure -S" work fine so if you take the newspak config.sh as a
  493.   starting point, you'll be very close.
  494.  
  495.   Compiling for NNTP reading is as simple as answering "yes" when
  496.   Configure asks you if you want to do so (assuming Configure runs ok on
  497.   your system).  A future release of newspak will include a config.sh
  498.   for NNTP reading as well as the existing one for local reading for
  499.   those of us who are still "bash-impaired" :-)
  500.  
  501.   I've run trn over a SLIP link as a NNTP-based newsreader.  If you're
  502.   connecting to a system that has a full newsfeed, you will grow
  503.   extremely old waiting for it to load up the "active" file and to
  504.   thread the articles.
  505.  
  506.   There are dozens of command line switches for trn to get all kinds of
  507.   behavior.  Read the "trn" man page for details.  I use a nice feature
  508.   to set all the switches easily:
  509.  
  510.  
  511.   o  make a file with all the settings in a file called  /.trnrc
  512.  
  513.   o  export TRNINIT=" /.trnrc"
  514.  
  515.   The current newspak has a copy of my .trnrc file as an example.
  516.  
  517.   trn3.2 and above has support for NOV or mthreads threading that's
  518.   user-selectable.  Accordingly, I recommend building the software to
  519.   allow both threading mechanisms (it's a question in Configure).  To
  520.   pick one at runtime, try "trn -Zo" for NOV and "trn -Zt" for mthreads.
  521.  
  522.   To build the mthreads database, do something like the following in the
  523.   "news" crontab:
  524.  
  525.  
  526.           # thread the trn database
  527.           35 * * * * /usenet/bin/mthreads all
  528.  
  529.  
  530.  
  531.   5.3.  NN
  532.  
  533.   The newspak distribution on sunsite contains working config files for
  534.   nn6.4.18 that you can drop into place and type "make" under Linux.
  535.   They also work with the 6.5b3 beta of the coming nn6.5 update.
  536.  
  537.   When you're done compiling, you need to do the following:
  538.  
  539.   o  - run the "inst" program to install things.  (install everything)
  540.  
  541.   o  - initialize the database
  542.  
  543.   o  - fire up nnmaster
  544.  
  545.   See the nn docs for details.  Compiling, configuring, and running nn
  546.   under Linux is no different than running nn on any other *nix with the
  547.   exception that you may want to run nnmaster as a cron entry rather
  548.   than as a daemon.  If you run it as a daemon under linux, it may not
  549.   tend to wake up properly (the net effect of running it from cron is
  550.   the same anyway).
  551.  
  552.   Support of "nn" is as simple as the following crontab entries:
  553.  
  554.           # run nnmaster to collect "nn" stuff
  555.           25 * * * * /usenet/sw/nn/lib/nnmaster
  556.  
  557.           # expire the nn database
  558.           0  4       * * * /usenet/sw/nn/bin/nnadmin =EYW
  559.  
  560.           # stash a copy of the active file for "nngoback" and keep last 7
  561.           0 3 * * * /usenet/sw/nn/lib/back_act 7
  562.  
  563.  
  564.  
  565.   I've experimented a little with running nn as a NNTP-based newsreader
  566.   over a SLIP connection.  In this case, you'll want to edit the
  567.   config.h file slightly.  See the comments in the file for details.
  568.   When running as a NNTP-based reader, nn runs a local copy of nnmaster
  569.   to keep the threads database on the local system so that article
  570.   selection is very fast (although you of course wait for the arcticle
  571.   text a little if you're running SLIP over a modem).
  572.  
  573.  
  574.   5.4.  Other newsreaders
  575.  
  576.   The following is a non-inclusive list of newsreaders said to install
  577.   and run under Linux:
  578.  
  579.   o  tass
  580.  
  581.   o  xrn
  582.  
  583.   o  gnus
  584.  
  585.  
  586.   6.  Acknowledgements
  587.  
  588.  
  589.   The following people have helped in the assembly of the information
  590.   (and experience) that helped make this document possible:
  591.  
  592.   Ed Carp, Steve Robbins, Ian Taylor, Greg Naber, Matt Welsh, Iain Lea,
  593.   Arjan de Vet
  594.  
  595.   If I forgot anybody, my apologies.
  596.  
  597.  
  598.   7.  Frequently Asked Questions about USENET (in c.o.l.* anyway)
  599.  
  600.  
  601.  
  602.  
  603.   7.1.  Why can't I post to moderated groups ?
  604.  
  605.   Probably because the newsreader is trying to call /bin/mail to send
  606.   the mail and it doesn't like it.  Replace the /bin/mail in SLS with
  607.   the port of mailx-5.3b.tar.z from the
  608.   pub/Linux/system/Mail/mailhandlers dir on sunsite.unc.edu and make it
  609.   mode 2755 and group mail (like "elm") and you'll be all set.
  610.  
  611.   Another possibility is that you have a moderated newsgroup set up on
  612.   your local system as not-moderated and somebody upstream is quietly
  613.   deleting the article (some system's software, not a person).  Make
  614.   sure you run a "checkgroups" every now and then when the checkgroups
  615.   article rolls by in news.admin every few weeks.
  616.  
  617.  
  618.   7.2.  Why do I have problems that appear to be permission-related ?
  619.  
  620.   Because they are :-)
  621.  
  622.   Check to see that your permissions are right and that you have a
  623.   "news" username and group in /etc/passwd and /etc/group that matches
  624.   the binary distribution you grabbed.  It seems that there is not yet a
  625.   Linux-standard for commonly available accounts.
  626.  
  627.   All the stuff in /usr/local/lib/news should be news.news except
  628.   /usr/local/lib/news/setnewsids which should be setuid root.
  629.  
  630.   You can use whatever UID and GID you want for "news".
  631.  
  632.  
  633.   7.3.  Why can I post articles locally, but they don't get fed down-
  634.   stream ?
  635.  
  636.   Probably because you didn't call newsrun from cron.  Maybe because you
  637.   edited your sys file and messed it up.  Maybe because you don't have a
  638.   /usr/spool/news/out.going tree or something.
  639.  
  640.   Do not create newsgroups or feeds by editing the active or sys files.
  641.   Use the utilities in /usr/local/lib/news/bin/maint to do it.
  642.  
  643.  
  644.   7.4.  Why doesn't my binary distribution have the "Performance
  645.   Release" of C-news?
  646.  
  647.   Because it's optional.  Because it has problems under Linux in some
  648.   places.  Because the Pre-Performance Release Cnews is more stable and
  649.   plenty fast enough on any type of reasonable system (IMHO). If you
  650.   need any more convincing, here's a few excerpts from the C-news
  651.   README.new file:
  652.  
  653.   "This is the 20 Feb 1993 Performance Release of C News, a minor update
  654.   to the 2 May 1992 P.R. that just fixes some installation problems and
  655.   a couple of annoying bugs"
  656.  
  657.   "This release is more or less a halfway step to what we've been
  658.   calling the "cleanup release""
  659.  
  660.   "People who are happy with the older C News might want to wait for the
  661.   cleanup release, which is still coming although behind schedule"
  662.  
  663.   Mainly because at the time SLS1.01 came out, the compilers and libs
  664.   didn't like the Performance Release too much.  Things are better now.
  665.  
  666.  
  667.  
  668.  
  669.   7.5.  Why doesn't my binary distribution have nntp ?
  670.  
  671.   Because it's supposed to be plug-n-play under Linux and because I
  672.   didn't want to make SLS's news stuff doubly big by having to maintain
  673.   both nntp and non-nntp versions of the newsreaders and news transport
  674.   programs.  Also because it compiles in localized information that is
  675.   not overridable at runtime via a config file.
  676.  
  677.  
  678.   7.6.  Why does doexpire (or relaynews or) say "severe space shortage"
  679.   when there's lots of room ?
  680.  
  681.   Because it can't read /etc/mtab.  Make it mode 644.  This happens when
  682.   you unmount a mounted filesystem by root with a umask that doesn't
  683.   permit world-read of files owned by root.
  684.  
  685.  
  686.   7.7.  Why does everything look normal, but posting doesn't happen ?
  687.  
  688.   Older versions of Linux had a "broken" sed that Cnews was prone to
  689.   blow up.  In particular, if you've installed over an old SLS, be sure
  690.   to check /bin and /usr/bin to be certain you have only one copy of sed
  691.   and that it's a modern one.
  692.  
  693.   If you're running the "Performance Release" of Cnews, posting runs
  694.   from cron which suprises some people.
  695.  
  696.  
  697.   7.8.  the various independent thread databases ?  Can I hook the new
  698.   news overview (NOV) stuff into trn/tin/nn to replace
  699.  
  700.   Yes. trn, tin, and the beta of nn support it now.
  701.  
  702.   You can hook it into the Performance Release of Cnews and various
  703.   other readers as well.
  704.  
  705.   The beta copy of nn6.5 I have here has NOV support and it works just
  706.   dandy under Linux.  I run it here and have nn running without having
  707.   to run nnmaster (!).  Look on uniwa.uwa.edu.au for a copy of it.
  708.  
  709.  
  710.   7.9.  Why can't we have a binary distribution of NNTP ?
  711.  
  712.   Because significant local-only information is compiled-in and cannot
  713.   be determined auto-magically at runtime.
  714.  
  715.  
  716.   7.10.  storing any news articles or databases locally.  How do I set
  717.   up NNTP to allow read/post across the network while *not*
  718.  
  719.   ( mdw@sunsite.unc.edu (Matt Welsh) )
  720.  
  721.   o  1) Grab the "reference implementation" of nntp and a copy or rn
  722.      from your local archive site.  If you connect to ftp.uu.net you'd
  723.      grab:
  724.  
  725.      nntp.1.5.11.tar.Z from ftp.uu.net:/networking/news/nntp
  726.  
  727.   o  2) compile nntp as follows:
  728.  
  729.      copy common/conf.h.dist to common/conf.h.
  730.  
  731.      Edit common/conf.h to set certain options: The only ones I set
  732.      were:
  733.  
  734.      DOMAIN: undefine it (i.e. change the line to #undef DOMAIN).
  735.      REALDOMAIN: Define this. It looks up the domain using the
  736.      libraries.
  737.  
  738.      SERVER_FILE: Set this to the name of the file which will contain
  739.      the hostname of the news server (i.e. the machine you'll read and
  740.      post news through). I use "/usr/local/lib/news/server".
  741.  
  742.      PASSFILE: If your news server requires authorization (i.e.  some
  743.      kind of username/password) to post, set this to the name of the
  744.      file which contains the username and password (described below).  I
  745.      use "/usr/local/lib/news/nntppass".
  746.  
  747.      I decided to keep all of the other news stuff in
  748.      /usr/local/lib/news.  So I set all of the rest of the pathnames in
  749.      the file (i.e.  ACTIVE_FILE, NEWSGROUPS_FILE, etc.) to use
  750.      /usr/local/lib/news.  Many of these files are only used by the NNTP
  751.      server, not the client, but to be safe I changed them all to point
  752.      to the right directory. You can of course use the default
  753.      pathnames; just make sure you create the directory accordingly.
  754.  
  755.      3) Create the user "usenet" if you haven't already. The inews
  756.      program runs as this user. All you need is a userid; you don't need
  757.      a home directory or shell or anything for the user. Just plop the
  758.      following line into your /etc/passwd:
  759.  
  760.                                      usenet:*:13:1::/:
  761.  
  762.  
  763.   Make sure you set the userid ("13", above) to something unique. The
  764.   group can be anything; I use "daemon" (gid 1).
  765.  
  766.   o  4) Create the SERVER_FILE, above. For example, my news server is
  767.      "wonton.tc.cornell.edu", so I created the file
  768.      /usr/local/lib/news/server which contained one line:
  769.  
  770.                       wonton.tc.cornell.edu
  771.  
  772.  
  773.  
  774.   o  5) Create the PASSFILE. This file contains lines of the form
  775.  
  776.                      <server name> <username> <password>
  777.  
  778.  
  779.   Let's say that your news server (the one in SERVER_FILE, above) is
  780.   "shoop.vpizza.com", and to post on that machine you need to be autho-
  781.   rized as the user "news" with a password of "floof". Thus, in the
  782.   PASSFILE (I use /usr/local/lib/news/nntppass), you need the line
  783.  
  784.                   shoop.vpizza.com news floof
  785.  
  786.  
  787.  
  788.   o  6) Make this file secure! The inews program runs as the user
  789.      "usenet", so make this news directory owned by that user and the
  790.      nntppass file as well.
  791.  
  792.              chown usenet /usr/local/lib/news
  793.              chmod 755 /usr/local/lib/news
  794.              chown usenet /usr/local/lib/news/nntppass
  795.              chmod 600 /usr/local/lib/news/nntppass
  796.  
  797.  
  798.   So nobody else can read this file. No, the passwords in it are not
  799.   encrypted.
  800.  
  801.   o  7) Go back to the nntp.1.5.11 source directory; issue "make
  802.      client".  At this point you'll build the NNTP version of inews,
  803.      which is the only software used by the NNTP client.
  804.  
  805.      When I built inews, there was a bug in the library which caused the
  806.      function uname() in uname.c to call itself eternally. This should
  807.      be gone now; however, if inews seems to hang and your system starts
  808.      slowing down *a lot* you should rename the function "uname()" in
  809.      uname.c to something like "my_uname()", and change the calls to it
  810.      (in inews.c) to call my_uname() instead. Mail me if you run into
  811.      this problem.
  812.  
  813.                      (VDS note - this means mail to Matt-not me :-) )
  814.  
  815.  
  816.  
  817.   o  8) Issue "make install_client". This will install the inews stuff.
  818.      Also link /usr/local/lib/news/inews to /usr/local/bin/inews
  819.  
  820.      Now you should be able to happily post (by hand). Try something
  821.      like the following:
  822.  
  823.                      $ inews -h << EOF
  824.                      Newsgroups: misc.test
  825.                      From: me@foo.bar.com
  826.                      Subject: Testing
  827.                      Reply-To: my-real-address@wherever.edu
  828.  
  829.                      This is a test.
  830.                      EOF
  831.  
  832.  
  833.   If this works, inews should post the article. You'll know because
  834.   test-responders on misc.test will reply to the address on the Reply-To
  835.   line, above. Please don't do test postings on real groups, like c.o.l.
  836.   :)
  837.  
  838.